Shareware Grab Bag

home *** CD-ROM | disk | FTP | other *** search

/ Shareware Grab Bag / Shareware Grab Bag.iso / 013 / ibu.arc / IBU.DOC < prev

Wrap

Text File | 1984-11-13 | 69.4 KB | 2,285 lines

INCREMENTAL BACKUP UTILITY V1.05 06/15/84 Mike Hodapp 5609 Apache Road Louisville, KY 40207 PREFACE INCREMENTAL BACKUP UTILITY 1.05 ENHANCEMENTS This version contains the following improvements: changes in the display of the function key definitions. several changes to this document to allow it to be printed on most printers. INCREMENTAL BACKUP UTILITY 1.04 ENHANCEMENTS This version contains the following improvements: allows the copying of DOS volume labels (DOS 2.0 and later only) to be requested via an optional parameter on the invocation command line or when restarting the backup utility. Once enabled, the label copy option remains on until it is turned off via a restart parameter. allows paths (DOS 2.0 and later only) to be specified, both at initial command entry time and when restarting the backup utility. provides the DOS editing keys for use while keying in the paths, file specifications and label copy options when restarting. provides significant improvements to the restart screen, including the display of parameters entered for the previous run, a reverse video area for entering new parameters, a description of the DOS editing keys, the identification of the default disk/diskette drive, and the status of the volume label copy option. provides various enhancements to the screen display functions, especially for color monitor users. INCREMENTAL BACKUP UTILITY 1.03 ENHANCEMENTS This version contains the following improvements: does not attempt to backup zero length files; previous versions which allowed this may have created directory errors when backing up zero length files. does copy DOS 2.0 volume labels (which are zero length.) expands the file attribute display using words and mnemonics providing for greater ease of use. increases the number of files allowed in the source and target directories to a maximum of 255 (see explanation of message 501.) allows the user to control the characteristics of monitors attached to the IBM Color/Graphics adapter. provides a new algorithm for determining the source and target disk/diskette drives, always making a "reasonable" selection when the user does not specify which drive(s) to use. provides for interrupting the backup process after the RUN key has been pressed, using the Ctrl-Break key for quick interruptions and the S1 key for a delayed interrupt. provides for interrupting while deleting files by pressing the Ctrl-Break key. INCREMENTAL BACKUP UTILITY FUTURE ENHANCEMENTS Some possible future enhancements which are being considered include: provide, via function keys, for displaying the source files in character and/or hexadecimal format with browsing and searching facilities. provide, via function keys, for full directory displays, similar to the current file display, but with just one line per file. provide Huffman encoding technique(s) and/or character compression routines for optionally reducing the size of the backup files, allowing more files on each backup volume. Any additional recommendations for enhancements would be greatly appreciated. INCREMENTAL BACKUP UTILITY INTRODUCTION OVERVIEW The Incremental Backup Utility provides an easy method for backing up new or modified disk and diskette files. Some of it's features include: - Operates as a DOS command. - Displays the amount of free space on both the source and the target disk/diskette. - Displays the space required on the target disk/diskette for the backup operation. - Provides full screen display of the file names selected for backup. - Allows scrolling of the display using PgUp, PgDn, Home and End keys. - Provides 7 sorting sequences for the file display. - Allows files selected for backup to be marked for exclusion from backup. - Allows files selected for backup to be marked for deletion. - Allows files marked for exclusion or deletion to be unmarked prior to actually being excluded or deleted. - Provides a display of the function key definitions. - Allows the function key definitions to be toggled off providing for the display of an additional file name. - Can be reused any number of times without being reloaded into memory. - Will copy any valid DOS file including those with special file attributes. - Will copy a volume label (DOS 2.0 or later) if the label option is specified. - Allows paths (DOS 2.0 or later) to be specified for both source and target disk/diskettes. INCREMENTAL BACKUP UTILITY 1 CAPABILITIES This utility is designed to be an extension to DOS and is invoked like any other DOS command. As with many of the other DOS commands, file specifications and an optional parameter may be entered on the command line. The file specifications are used to qualify the files to be backed up and the names of the backup files. The optional parameter enables the utility option to copy DOS 2.0 (or later) volume labels. The backup copy of a file may be on the same disk or diskette as the original file if its filename and extension are different than the original file. The names of all files which are candidates for backup are displayed for you to examine. A file becomes a candidate based on its directory date and timestamp compared to the date and timestamp of its backup file. Files may be excluded from the display and as candidates for backup via function key. It is also possible to delete files that have been selected for backup using a function key. The exclusion and deletion actions are "marked" on the display and do not actually take place until you press the "Process" function key or the "RUN" function key. This requirement for two actions reduces the possibility of accidents, especially in the case of deletions. Files marked for exclusion or deletion may also be "Unmarked". The unmarking may be done individually or all marks may be "Reset" at the same time. The display heading reflects the file specifications entered at invocation time, the amount of free space on both the source and the target disk/diskette, and the invocation time and date. See Appendix A, SCREEN LAYOUT. The body of the display contains a line for each file selected for backup and second line for its backup file. Each of these display lines contains the date and timestamp of the file as well as its size and file attributes. The last two lines of the display may be used to display the function key definitions or to display file information. The last line of the display will also be used to display any messages generated by the utility. You can sort the display into any of seven sequences via function keys. INCREMENTAL BACKUP UTILITY 2 A function key is defined as "Quit" to allow you to terminate the current display activity at any time. The utility can be restarted without having to be reinvoked as a DOS command. You are given the option to restart or terminate the utility when the current processing is completed. This eliminates having to reload the program from disk/diskette for each use when you have several diskettes to backup or some other multiple backup activity. Any valid DOS file may be copied. Zero length files are not considered valid files and will not be backed up. Any attempt to backup a zero length file will be ignored during the actual copy processing. Subdirectory entries (DOS 2.0 or later only) will not be copied since they are zero length files. The exception to this is the volume label. Volume labels may be copied, providing a means other than the FORMAT command (DOS 2.0 or later) for labeling volumes. This is convenient when you wish to label a volume which already has files on it. You can copy or copy-with-rename a label from a volume which has a valid DOS label. The label created will have its date and timestamp set to the current DOS values, indicating when it was actually placed on the disk/diskette. A volume label will be copied to the root directory, even when the target of the backup operation is a subdirectory. Attempting to copy a second label to a volume produces an error message and terminates the current backup process. The deletion of volume labels (DOS 2.0 or later) is not supported. Paths are fully supported (DOS 2.0 or later) allowing you to copy from any directory/subdirectory to any other directory/subdirectory, even on the same disk/diskette. Some care is required when using the Incremental Backup Utility to backup or copy the two files IBMBIO.COM and IBMDOS.COM. These two files are the DOS system modules loaded into memory when you start DOS. They need to be the first files physically on a volume; they are normally placed properly by the DOS FORMAT or SYS commands. While the Incremental Backup Utility will copy these files, it cannot guarantee copying them to their required locations for creating a DOS system. They will be copied to the first "available" sectors on the target disk/diskette. INCREMENTAL BACKUP UTILITY 3 BENEFITS The major benefit of the Incremental Backup Utility is its ability to automatically select for backup any new files or any file that has been modified since the last backup of that file. This relieves the burden of remembering or determining which files need to be backed up. It is not necessary to specify the files to be backed up as is required by the DOS COPY command. It also allows selective copying of a file even after the file has qualified for automatic backup. The user has more control over the files to be backed up than is possible with the DOS COPY command when using global characters in the file specifications. The ability to select the files to be backed up allows for the possibility of backing up more than one diskette on a single backup diskette. Many times not all the files on a disk/diskette need to be backed up. This is the case, for example, with disks/diskettes used by compilers; source files and batch files need to be backed up, but not LST, OBJ, EXE or work files which are easily recreated. HARDWARE REQUIREMENTS The Incremental Backup Utility requires an IBM Personal Computer with 64K of memory, two diskette drives (or one diskette drive and one disk) and an eighty column display. SOFTWARE REQUIREMENTS The Incremental Backup Utility has been written in assembler language to minimize its size and maximize its speed. The Incremental Backup Utility requires the IBM Personal Computer Disk Operating System (DOS). It has been tested with DOS version 1.1, 2.00 and 2.10. INCREMENTAL BACKUP UTILITY 4 HOW TO USE THE PROGRAM INVOCATION The Incremental Backup Utility is invoked like any other DOS external command by keying in its name, IBU. The command may be qualified by keying in one or two file specifications and an optional parameter. The command format is: IBU [d:][path][filename[.ext]] [d:][path][filename[.ext]] [/L] The first parameter you specify identifies the source file(s). The second parameter identifies the target file(s). You may use the global characters ? and * in the filename and in the extension of both the source and target files. If you use the /L parameter the Incremental Backup Utility will display and allow copying of DOS 2.0 (or later) volume labels if they qualify for selection. The volume label option will remain on for this invocation of the utility until it is turned off by a /N parameter in a subsequent restart specification. The /L parameter is also valid as a restart parameter. Examples: 1. IBU will display all the candidate files on the default disk/diskette drive for backup to the target drive. - If your system has two diskette drives only and if A is the default drive then the backup will be from drive A to drive B. - If your system has a C drive and if A is the default drive then the backup will be from drive A to drive C. - If A is not the default drive then the backup will be from the default drive to drive A. 2. IBU a: will display all the candidate files on drive A for backup to the target drive. - If your system has two diskette drives only, drive B will be the target drive. - If A is not the default drive, the default drive INCREMENTAL BACKUP UTILITY 5 will be the target drive. - If your system has a C drive and A is the default drive, the C drive will be the target drive. 3. IBU b: will display all the candidate files on drive B for backup to the target drive. - If B is not the default drive, the default drive will be the target drive. - If B is the default drive, the A drive will be the target drive. - This example can be generalized for any drive except the A drive, i.e., the "b" and "B"s above apply to any drive identifier other than "A". 4. IBU *.bas will display all the files with an extension of BAS on the default drive. - The selection of a target drive will be the same as for the first example. 5. IBU *.abc *.cba will display all the files with an extension of ABC on the default drive which are candidates for backup to the target drive with the same file name, but with extension CBA. - The selection of a target drive will be the same as for the first example. 6. IBU xyz*.* will display all the files with names beginning XYZ on the default drive which are candidates for backup to the target drive. - The selection of a target drive will be the same as for the first example. 7. IBU xyz*.* zyx*.* will display all the files with names beginning XYZ on the default drive which are candidates for backup to the target drive with names beginning ZYX. - The selection of a target drive will be the same as for the first example. INCREMENTAL BACKUP UTILITY 6 8. IBU ab??ef will display all the files with names beginning AB followed by any two characters and ending with EF which are candidates for backup to the target drive. Note that there is no extension. - The selection of a target drive will be the same as for the first example. 9. IBU a:*.pas a:*.pab will display all the files with an extension of PAS on the A drive which are candidates for backup to the A drive with an extension of PAB. 10. IBU c:\SUB1\SUB2\SUB3\*.* c:\SUB4\*.* will display all the files in path \sub1\sub2\sub3\ on drive C which are candidates for backup to the C drive in path \sub4\. 11. IBU #asmwork.001 #asmwork.002 /l will display the label #ASMWORK001 and allow the label #ASMWORK002 to be created on the target volume. - The selection of a target drive will be the same as for the first example. INCREMENTAL BACKUP UTILITY 7 DISPLAYING THE FUNCTION KEY DEFINITIONS. Many of the functions available while the candidate files are being displayed are controlled by the function keys F1-F10. The function key definitions are displayed on the last two lines of the monitor. The F1 function key is a toggle key: if the function key definitions are not being displayed, pressing F1 displays the definitions; if the function key definitions are being displayed, pressing F1 allows file specifications to be displayed on the last two lines of the monitor. F1 may be used any number of times. You may want to disable the the function key display to allow more room for displaying file specifications. FUNCTION KEY DEFINITIONS. Several of the function keys have dual functions. The second function is selected by holding down either of the shift keys while pressing the function key. You may find it more convenient to use the shift key on the right side of the keyboard so you can use both hands. In the following text the use of the shift key with a function key is indicated by an S followed by a number while normal function key usage is indicated by a F followed by a number. F1 - Keys = Function Key Display Toggle. See the above section on DISPLAYING THE FUNCTION KEY DEFINITIONS. F2 - Color = Modify the C/G Adapter display attributes. You will be prompted to modify the display attributes for the monitor(s) attached to the IBM Color/Graphics Adapter. You should be able to determine the attributes which are most pleasing for you on the monitor you are using with this utility. See message number 701 and COLOR/GRAPHICS ADAPTER CONTROL. Note. Unless you are actually using the C/G adapter this function key is undefined and the word Color will not appear on your display. F3 - Names = Sort by Filename, Extension. Sort the display by the source filename and extension. INCREMENTAL BACKUP UTILITY 8 F4 - Exts = Sort by Extension, Filename. Sort the display by the source extension and filename. F5 - Dates = Sort Descending by Date and Timestamp. Sort the display in descending order by the source date and timestamp, i.e., the most current date and time first. F6 - Sizes = Sort Descending by Size. Sort the display in descending order by the size of the source file, i.e., the largest file first. F7 - Adate = Sort by Date and Timestamp. Sort the display by source date and time, i.e., the oldest file first. F8 - Asize = Sort by Size. Sort the display by the size of the source file, i.e., the smallest file first. F9 - eXcld = Exclude. Mark the file on the line where the cursor resides for exclusion from backup. An X is placed on the line with the file to be excluded. The exclusion can be reset and the X removed by using the Unmrk function key - see F10. All the files marked for exclusion using the eXcld function key may be unmarked by using the Reset function key - see S2. The file marked for exclusion may be excluded from the display by pressing the ProcM function key - see S3. Once excluded from the display a file may not be redisplayed or otherwise processed without restarting the utility. INCREMENTAL BACKUP UTILITY 9 F10 - Unmrk = Unmark. Unmark the file on the line where the cursor resides. When a file has been previously marked for exclusion or deletion, this key may be used to reset the mark. The use of marks for exclusion and deletion and the ability to reset the marks enhances the usability of the Incremental Backup Utility - it gives you a chance to confirm whether or not a file should be excluded or actually deleted. S1 - Quit. Terminate the current display activity. This key is also active during the actual copy operation and may be used to terminate the copy Run after the active file copy completes. See also the Ctrl-Break key description. S2 - Reset. Reset all marks. This will unmark all files currently marked for either exclusion or deletion. A subfunction sorts the files to their original order, i.e., the order in which they exist in the directory of the source disk/diskette. S3 - ProcM = Process all the currently marked files. Press this key if files marked for exclusion are to be excluded from any further display or if files marked for deletion are to actually be deleted. The the number of sectors required for backup will be updated in the heading line. S4 - RUN = Backup any unmarked file. Perform the backup operation. A subfunction first processes all the marked files - see S3. S5 - Undefined. S6 - Undefined. S7 - Undefined. S8 - Undefined. INCREMENTAL BACKUP UTILITY 10 S9 - Delet = Mark for deletion. Mark the file on the line where the cursor resides for deletion. A character D is placed on the line with the file to be deleted. The deletion can be reset and the D removed by using the Unmrk function key - see F10. All the files marked for deletion using the Delet function key may be unmarked by using the Reset function key - see S2. The file marked for deletion is actually deleted by pressing the ProcM function key - see S3, or the RUN function key - see S4. S10 - Paths = Display the source and target paths. The file name display will be replaced by a screen which will: Display the current source path if different from the its default path, i.e., if the user specified a source path. Display the default source path, i.e., the path in effect when the utility was invoked. Display the current target path if different from the its default path, i.e., if the user specified a target path. Display the default target path, i.e., the path in effect when the utility was invoked. The default paths will always be displayed, the current paths only if you specified a path. This function will be useful when you need to know the status of the paths to the active subdirectories. The file name display is reinitialized by pressing any non-control key. Note. Paths only have meaning in DOS 2.0 or later. For DOS 1.1 this function key is undefined and the word Paths will not appear on your display. OTHER KEYS. The cursor control keys and the page control keys on the right side of the keyboard are used to manipulate the display screen. HOME - Redisplay the first page. END - Display or redisplay the last page. INCREMENTAL BACKUP UTILITY 11 PgUp - Scroll up one full page, displaying those files closer to the beginning of the current sorting sequence. PgDn - Scroll down one full page, displaying those files closer to the end of the current sorting sequence. Cursor Down - Move the cursor down to the next displayed candidate file. If at the bottom of the display page scroll the current display up a half page. Cursor Up - Move the cursor up to the next displayed candidate file. If at the top of the display page scroll the current display down a half page. Return - Same as the Cursor Down key. Ctrl-Break - Terminate the current processing. You may use the Ctrl-Break anytime you wish to interrupt the utility. In most cases you will be immediately presented with message number 302 which allows you to exit to DOS or restart the utility. If you use the Ctrl-Break key while a file is being copied, the backup copy will be deleted from the target disk/diskette. This means that neither the old backup copy, which has already been deleted, nor the new copy will exist on the target disk/diskette. Once the copy process has started, it is not possible to recover the previous backup copy of a file. See also the S1 key description. INCREMENTAL BACKUP UTILITY 12 COLOR/CRAPHICS ADAPTER CONTROL. You can control the colors, intensity and blinking characteristics of your monitor attached to the IBM Color/Graphics adapter. This facility is made available because of the large variety of monitors which can be attached to the C/G adapter. It is impossible to provide any single set of display attributes which will work well with all attachable monitors. The alternating pairs of source and target file specifications can have different background and foreground color attributes. The default set provides for black characters on a green background alternating with black characters on a brown background when using the IBM color monitor. You have the option of modifying the display attributes so that you can find one that works well with your monitor and is pleasant to work with. To change your C/G adapter attributes you must first press the F2 function key. This causes message 701 to be displayed: 701 : CURRENT C/G ATTRIBUTES ARE ABCD.4321 The current color/graphics attributes being used are displayed where the characters ABCD are. The characters 4321 are not part of the message but are used here to represent where you key in new attributes. The cursor will initially be where the 4 is. The character positions above represent the following: A is the first background color. B is the first foreground or character color. C is the second background color. D is the second foreground or character color. 4 will become the first background color. 3 will become the first foreground color. 2 will become the second background color. 1 will become the second foreground color. Any of the above character positions may contain or have keyed into it a valid hexadecimal digit, i.e., in the range 0-9,A-F. Both uppercase and lowercase alphabetic characters may be keyed, but all characters will be displayed in uppercase. Once a valid character has been keyed and displayed you may not change it; complete the current entry and press F2 again to make any changes. It is suggested that you experiment a little to determine which combinations work best on your monitor and are the INCREMENTAL BACKUP UTILITY 13 most pleasant for you to work with. There are over 65,000 combinations available. Some are great --- some are awful --- and some will display nothing! CODE BACKGROUND FOREGROUND -------------------------------------------------------- 0 BLACK BLACK 1 BLUE BLUE 2 GREEN GREEN 3 CYAN CYAN 4 RED RED 5 MAGENTA MAGENTA 6 BROWN BROWN 7 LIGHT GRAY LIGHT GRAY 8 BLACK, BLINKING FOREGROUND DARK GRAY 9 BLUE, BLINKING FOREGROUND LIGHT BLUE A GREEN, BLINKING FOREGROUND LIGHT GREEN B CYAN, BLINKING FOREGROUND LIGHT CYAN C RED, BLINKING FOREGROUND LIGHT RED D MAGENTA, BLINKING FOREGROUND LIGHT MAGENTA E BROWN, BLINKING FOREGROUND YELLOW F LIGHT GRAY, BLINKING FOREGROUND WHITE A complete discussion of the C/G display attributes is beyond the scope of this documentation. The PC Technical Reference manual contains that information. Note. The second line of the function key definition display will be overlayed by message 701 allowing you to see the previous setting at ABCD and the new setting at 4321. The second line of the function key definitions may be restored by pressing the F1 key twice. INCREMENTAL BACKUP UTILITY 14 APPENDIX A FILENAME DISPLAY SCREEN LAYOUT The screen layout for the Incremental Backup Utility is described in this appendix. In the examples column positions on the screen are identified by the tens position numbers over the dashed line with the units position numbers. Line 1 is a title line displayed in reverse video. It will contain information in the following format (shown here split after column 45): 0 1 1 2 2 3 3 4 4 ----5----0----5----0----5----0----5----0----5 <-Columns A:I???????.??? 06/13/83 16:08 179 4 5 5 6 6 7 7 8 6---0----5----0----5----0----5----0 B:O???????.??? 187 20 Line 1 positions 1-14 contain the source file specification. The disk/diskette drive identifier is the first character. The file name follows the semicolon and the file extension follows the period. A "?" character in the file name or extension indicates a "wild card" position, i.e., one not checked when determining which source files are candidates for backup. In this example, the user has keyed in a source file specification ("a:i*.*" is one possibility). Line 1 positions 16-23 contain the current date in the form MM/DD/YY. Line 1 positions 25-29 contain the current time (the invocation time) in the form HH:MM. Line 1 positions 40-43 contain the number of unused sectors on the source disk/diskette. Line 1 positions 47-60 contain the target file specification. As with the source file specification, a "?" character in the file name or extension indicates a "wild card" position. In the case of the target file, however, it means this position in the name or extension is or will be a duplicate of the same position in the source file name or extension. In the sample, the user has keyed in a target file specification ("b:o*.*" is one possibility). APPENDIX A FILENAME DISPLAY SCREEN LAYOUT 15 Line 1 positions 62-65 contain the number of unused sectors on the target disk/diskette. Line 1 positions 67-70 indicate how many sectors are required to backup the files currently selected as candidates for backup. If this number is greater than the number of unused sectors on the target disk/diskette, then you must exclude one or more files before pressing the "RUN" key; otherwise an error will occur when the target disk/diskette becomes full during the copying of one of the files (see message 902). This number will blink when it is greater than the number of unused sectors on the target disk/diskette. Line 1 position 71 will contain a minus sign (-) if the sectors required to backup the selected files is negative. This means that the free space on the target volume will increase after the copying is complete. Your newer file(s) are smaller than their predecessors. Line 2 contains the file characteristics of a source file. Line 3 contains the file characteristics of a target file. Lines 2 and 3 will be formatted as follows: 0 1 1 2 2 3 3 4 4 5 5 6 ----5----0----5----0----5----0----5----0----5----0----5----0 IFILE1 .E1 09/04/82 18:33 384 1 00 OFILE1 .E1 Line 2 describes the source file. Line 2 position 1 will display an "X" if this file has been marked for exclusion, or a "D" if marked for deletion. Line 2 positions 3-14 contain the file name and extension of a backup candidate. Line 2 positions 16-23 contain the last modification date of the candidate file. Line 2 positions 25-29 contain the last modification time of the candidate file. Note that while only hours and minutes are displayed, the time used internally is in two second increments which is what DOS stores in the disk/diskette directory. Line 2 positions 31-38 contain the file size by the number APPENDIX A FILENAME DISPLAY SCREEN LAYOUT 16 of bytes in the file. Line 2 positions 40-43 contain the file size by the number of sectors required to store the file on the target volume. Line 2 positions 47-48 indicate the file attributes for this file: 00 - no special attributes 01 - read only file (DOS 2.00 and later.) 02 - hidden file (not displayed by the DIR command.) 04 - system file (normally a DOS system file.) 08 - volume label entry (DOS 2.00 and later.) 10 - sub-directory entry (DOS 2.00 and later.) 20 - archive bit (DOS 2.00 and later.) The attributes are stored in the disk/diskette directory in a single byte. The above represents the hexadecimal mapping of the bits in the attribute byte. The attributes will frequently be combined, e.g., 26 indicates 20 + 02 + 04 and 1A (if legitimate) would indicate 10 + 02 + 08. Line 2 starting at position 49 will list the file attributes. The following words and mnemonics are used: RO - Read Only. H - Hidden S - System LABEL - Volume Label SUBDIR - Subdirectory A - Archive bit Line 3 contains file characteristics for the target of the source file on line 2. On the monochrome display, line 3 is underscored to make it easy to associate the target file with its source file. If you are using a monitor attached to the IBM Color/Graphics adapter, lines 2 and 3 will be the same color for easy association of the target file with its source. For more information see the section COLOR/GRAPHICS ADAPTER CONTROL. Line 3 positions 3-14 contain the file name and extension of the file to be created or replaced on the target disk/diskette by copying the candidate file on line 2. Line 3 positions 16-80 will be empty if a file must be created to backup the candidate file. Line 3 positions 16-23 contain the last modification date of the target file. In most cases this will be the modification date of the previous backup copy of the candidate file. APPENDIX A FILENAME DISPLAY SCREEN LAYOUT 17 Line 3 positions 25-29 contain the last modification time of the target file. Line 3 positions 31-38 contain the file size by the number of bytes in the file. Line 3 positions 40-43 contain the file size by the number of sectors used to store the file. Line 3 positions 47-48 indicate the file attributes for this file. Line 3 starting at position 49 will list the file attributes. Even numbered lines 4 thru 22 will be the same format as line 2 and the odd numbered lines 5 thru 23 will be the same format as line 3. Some examples of even-odd pairs of lines are: 0 1 1 2 2 3 3 4 4 5 5 6 ----5----0----5----0----5----0----5----0----5----0----5----0 IFILE2 .E2 09/04/82 13:54 896 2 07=S,H,RO OFILE2 .E2 09/01/82 23:00 796 2 26=A,S,H ILABEL#1.001 05/23/83 0 0 08=LABEL OLABEL#1.001 IFILE4 .E4 01/23/83 01:03 12416 25 20=A OFILE4 .E4 12/25/82 00:01 9216 18 00 IFILE5 .E5 01/01/80 512 1 00 OFILE5 .E5 IFILE6 .E6 01/23/83 01:03 22416 44 00 OFILE6 .E6 12/25/82 16:01 20101 40 00 Lines 24 and 25 are used to display the function key definitions unless toggled off by the F1 key. When the function key definitions are not being displayed lines 24 and 25 will be used to display an additional source and target file specification. Line 25 is used to display any message generated by the utility. APPENDIX A FILENAME DISPLAY SCREEN LAYOUT 18 Line 24 will normally display the following function key definitions: 0 1 1 2 2 3 3 4 4 ----5----0----5----0----5----0----5----0----5-- F1=Keys 2=Color 3=Names 4=Exts 5=Dates 6=Sizes 5 5 6 6 7 7 8 --0----5----0----5----0----5----0 7=Adate 8=Asize 9=eXcld 10=Unmrk Line 25 will normally display the following shifted function key definitions: 0 1 1 2 2 3 3 4 4 ----5----0----5----0----5----0----5----0----5-- S1=Quit 2=Reset 3=ProcM 4=RUN 5= 6= 5 5 6 6 7 7 8 --0----5----0----5----0----5----0 7= 8= 9=Delet 10=Paths APPENDIX A FILENAME DISPLAY SCREEN LAYOUT 19 APPENDIX B RESTART DISPLAY SCREEN. The restart display is provided to enable you to continue using the utility without its having to be reinvoked under DOS. In a diskette only system, this will reduce the number of times you must insert a diskette containing the utility as well as reduce the number of diskettes which must contain a copy of the utility. Line 1 contains the note: YOUR PREVIOUS SPECIFICATIONS WERE: Lines 2 and 3 contain the parameters you keyed on the DOS command line or that you specified during the previous restart. Line 5 contains the note: ENTER YOUR NEW SPECIFICATIONS: Lines 6 and 7 provide an area for you to specify new parameters. The area for the new specification is outlined in reverse video. Should your specification extend to the end of the area, the last position is reserved for the enter key (the only character acceptable in the last position is the enter key). The Incremental Backup Utility function key definitions are disabled while the restart screen is being displayed. Instead, the normal DOS function keys are available for entering or modifying utility file specifications and parameters. Line 13 displays the default disk/diskette drive following the note: DEFAULT DRIVE: This is provided as a reminder. Line 15 displays the volume label copy option following the note: VOLUME LABEL COPY OPTION: This is provided as a reminder. It will be either ON or OFF. It is turned on by entering a /L parameter. It is turned off by entering a /N parameter. The default will be off, but once turned on it remains on until you enter the /N parameter. The DOS edit key definitions are displayed in the lower right quadrant of the screen. While using the DOS edit keys the current position in the previous specification is shown in reverse video. The current position in the new specification is indicated by the cursor. The DOS edit keys work just as they do when entering a DOS command. The <- definition applies to both the backspace and cursor-left APPENDIX B RESTART DISPLAY SCREEN. 20 keys. The -> is the cursor-right key. The utility may be terminated by pressing the SHIFT-F1 key anytime the restart display is on your monitor. APPENDIX B RESTART DISPLAY SCREEN. 21 APPENDIX C MESSAGES All messages generated by the Incremental Backup Utility will be displayed on the last line of the monitor. Each message will have the following format: ### : MESSAGE where ### is a unique number. Unless prompted otherwise, all messages require that you press a non-control key such as the space bar or return key in order for the program to proceed. 201 : INSERT DISKETTES AS INDICATED ABOVE AND PRESS ANY KEY. The source drive and the target drive are displayed immediately above this message. If you need to change the diskettes currently in either of the drives you must do so now. 202 : INVALID SOURCE/TARGET PATH SPECIFICATION. PRESS ANY KEY. DOS 2.0 or later only. The path specified was not acceptable to DOS. Press any non-control key and the utility will return you to the restart screen where the path specification will be displayed in the area defined for your previous specifications. 203 : SOURCE/TARGET PATH HAS BECOME INVALID. DOS 2.0 or later only. The utility has attempted to issue a DOS CHDIR (Change Directory Command) for the indicated path and DOS has returned an invalid path response. This might occur if you have changed diskettes after responding to message 201. Press any non-control key and the utility will return you to the restart screen. APPENDIX C MESSAGES 22 204 : PRESS ANY KEY TO CONTINUE. The utility requires that you press some non-control key before it will resume. This message appears following the display of the current and default paths resulting from the S10 function key. 301 : PATH COULD NOT BE RESTORED FOR SOURCE/TARGET. PRESS ANY KEY. DOS 2.0 or later only. Any time paths have been specified for a backup operation the Incremental Backup Utility will attempt to restore the path as it existed at the time the utility was invoked. It attempts this restoration prior to displaying the restart screen. If restoration fails the path for the specified device will be its root directory. 302 : PRESS SHIFT-F1 TO TERMINATE, ENTER NEW FILE SPECIFICATIONS TO CONTINUE. All current processing has completed or you have pressed Ctrl-Break or the Shift-F1 key. Entering Shift-F1 will terminate the utility and return you to DOS. Entering source and target file specifications just as you would on the DOS command line when entering the original command restarts the utility. See the section on invocation. While keying in the source and target file specifications, the DOS edit keys may be used just as they would for entering a command following a DOS prompt. The DOS edit key definitions are displayed on the restart screen for your convenience. 501 : MORE THAN 255 SOURCE/TARGET FILES MEET YOUR SPECIFICATION. PRESS ANY KEY. DOS 2.0 or later only. The utility can not handle more than 255 file name entries in either the source or target directory. It is suggested that you qualify the relevant filespec to reduce the number of directory entries that need to be processed. Working with this number of files will prove very APPENDIX C MESSAGES 23 cumbersome. You should look into the possibility of creating multiple subdirectories and subdirectory levels rather than have one directory level with a large number of entries. The 255 limit should be more than adequate for the majority of users. Press any non-control key and the utility will return you to the restart screen. 601 : NO BACKUP CANDIDATE FILES. PRESS ANY KEY. No files on the source disk/diskette are candidates for backup. Press any non-control key and the utility will return you to the restart screen. 602 : FILE TO BE DELETED DOES NOT EXIST ON INPUT DISKETTE. The displayed file, previously marked for deletion can not be found on the input disk/diskette during processing of the marked files. You must have changed diskettes. Press any non-control key to continue. 603 : LABELS AND SUBDIRECTORIES MAY NOT BE DELETED. You have attempted to delete a DOS volume label or a DOS subdirectory entry. Deletion of DOS volume labels and subdirectories is not supported. Press any non-control key to continue. 701 : CURRENT C/G ATTRIBUTES ARE abcd. You have pressed function key F2. The current color/graphics attributes being used are displayed where the characters "abcd" are. You will be able to enter new attributes following the period in the message. See COLOR/GRAPHICS ADAPTER CONTROL. 801 : FILE DOES NOT EXIST ON INPUT DISKETTE. The displayed file can not be found on the input disk/diskette for copying. You must have changed diskettes. Press any non-control key to continue. APPENDIX C MESSAGES 24 802 : OUTPUT DISKETTE DIRECTORY IS FULL. The output disk/diskette directory has become full while copying the displayed file. Press any non-control key and the utility will return you to the restart screen. DOS 2.0 or later only. This message will also result when attempting to copy a second volume label onto a disk/diskette. 803 : CTRL-BREAK = IMMEDIATE QUIT, SHIFT-F1 = QUIT AFTER CURRENT FUNCTION. This message will display while files are being copied. The CTRL-BREAK will cause the copy function to be terminated and the backup file being created to be deleted from the target disk/diskette. The SHIFT-F1 key will cause the copy function to be terminated following completion of the current file copy. Use of either key will return you to the restart screen. 901 : ERROR READING INPUT FILE. An error has occurred while reading the displayed input file. Any partially copied file will have the current date and time and a filesize of 0 on the target disk/diskette. Press any non-control key and the utility will return you to the restart screen. Be sure to delete any partially copied file on the target disk/diskette. 902 : ERROR WRITING OUTPUT FILE. An error has occurred while writing the displayed output file. Any partially copied file will have the current date and time and a filesize of 0 on the target disk/diskette. Press any non-control key and the utility will return you to the restart screen. Be sure to delete any partially copied file on the target disk/diskette. One of the causes of this condition is insufficient space on the target disk/diskette. This can be true even when the space requirements for all the candidate files are less than the space available on the target: the sectors required by the file being copied when this message occurs are greater than the space APPENDIX C MESSAGES 25 currently available; files further down the candidate list are smaller than their predecessors on the target and will free space when copied. If the sectors available field in positions 68-71 on line 1 of the display is not blinking, this is what has happened. You should sort the candidate list into a different sequence to eliminate this condition or "eXclude" some candidates from the list and perform multiple copies using the restart capability of the utility. 903 : OUTPUT FILE CANNOT BE CLOSED. An error has occurred while closing the displayed output file. Press any non-control key and the utility will return you to the restart screen. 904 : OUTPUT FILE COULD NOT BE DELETED. You have pressed the CTRL-BREAK key in response to message 803, but the backup file being created on the target disk/diskette could not be deleted. Press any non-control key and the utility will return you to the restart screen. APPENDIX C MESSAGES 26 APPENDIX D FUNCTION KEY REFERENCE. FUNCTION KEYS. F1 - Keys = Function Key Display Toggle. F2 - Color = Modify the C/G Adapter display attributes. F3 - Names = Sort by Filename, Extension. F4 - Exts = Sort by Extension, Filename. F5 - Dates = Sort Descending by Date and Timestamp. F6 - Sizes = Sort Descending by Size. F7 - Adate = Sort by Date and Timestamp. F8 - Asize = Sort by Size. F9 - eXcld = Mark for exclusion. F10 - Unmrk = Unmark all marked entries. SHIFTED FUNCTION KEYS. S1 - Quit = Quit the current display activity. S2 - Reset = Reset all marks, sort the files to their original order. S3 - ProcM = Process all the currently marked files. S4 - RUN = Backup any unmarked file, process all the marked files. S5 - Undefined. S6 - Undefined. S7 - Undefined. S8 - Undefined. S9 - Delet = Mark for deletion. S10 - Paths = Display the source and target paths. OTHER KEYS. HOME - Redisplay the first page. END - Display or redisplay the last page. PgUp - Scroll up one full page. PgDn - Scroll down one full page. Cursor Down - Move the cursor down. Cursor Up - Move the cursor up. Return - Same as the Cursor Down key. Ctrl-Break - Terminate the current processing. APPENDIX D FUNCTION KEY REFERENCE. 27 APPENDIX E USER SUPPORTED SOFTWARE CONCEPT. AVAILABILITY Available from Mike Hodapp under the "user supported software" concept promoted by Jim Button and others. See below. COPYING The Incremental Backup Utility can be copied onto your diskettes for use on your machine. DISCLAIMER In no event will the author be liable to you for any damages, including any lost profits, lost savings or other incidental or consequential damages arising out of the use of or inability to use this program, even if the author has been advised of the possibility of such damages, or for any claim by any other party. PERMISSION TO COPY Clubs and other non-profit organizations are granted permission by the author to freely copy these programs and documentation and share it with their members, so long as: 1. No price is charged for the software or documentation. However, a distribution cost may be charged for the cost of the diskette, so long as it is not more than $10 total. 2. Club members are informed of the user-supported concept and encouraged to support it with their donations. 3. The program or documentation are not modified in any way and are distributed together. THE USER-SUPPORTED CONCEPT User-Supported Software If you are using this program and find it to be of value your contribution will be appreciated. ($20 is suggested) Mike Hodapp 5609 Apache Road Louisville, KY 40207 Regardless of whether you make a contribution, you are encouraged to copy and share this program. APPENDIX E USER SUPPORTED SOFTWARE CONCEPT. 28 User-supported software is an experiment in distributing computer programs, based on these beliefs: 1. That the value and utility of software is best assessed by the user on his/her own system. 2. That the creation of personal computer software can and should be supported by the computing community. 3. That copying of programs should be encouraged, rather than restricted. Anyone may request a copy of a user-supported program by sending a blank, formatted disk to the author of the program. An addressed, postage-paid return mailer must accompany the disk (no exceptions, please). A copy of the program, with documentation on the disk, will be sent by return mail. The program will carry a notice suggesting a contribution to the program's author. Making a contribution is completely voluntary on the part of each user. Free distribution of software and voluntary payment for its use eliminates costs for advertising and copy protection schemes. Users obtain quality software at reduced cost. They can try it out before buying, and do so at their own pace and in the comfort of their own home or office. The best programs will survive, based purely on their quality and usefulness. Please join the experiment. If you believe in these ideals, your contribution is solicited to help make them work. For those of you requiring an invoice in order to initiate payment through your company accounting system, the following invoice is provided. Those who wish an invoice for their tax records may also find it useful. APPENDIX E USER SUPPORTED SOFTWARE CONCEPT. 29 -------------------- INVOICE -------------------- Purchased from: Mike Hodapp 5609 Apache Road Louisville, KY 40207 DATE: / / ---------------------------------------------------------------- PRICE PRICE PRODUCT QTY EACH EXTENDED ------------------------- --- ----- -------- INCREMENTAL BACKUP UTILITY program and documentation 1 $20 $20 SALES TAX 0 -------------------------------------- PLEASE PAY THIS AMOUNT $20 TOTAL ---------------------------------------------------------------- Please make check payable to : Mike Hodapp You may retain this Invoice for your tax records. CONTENTS INCREMENTAL BACKUP UTILITY 1.05 ENHANCEMENTS..... 1 INCREMENTAL BACKUP UTILITY 1.04 ENHANCEMENTS..... 1 INCREMENTAL BACKUP UTILITY 1.03 ENHANCEMENTS..... 1 INCREMENTAL BACKUP UTILITY FUTURE ENHANCEMENTS... 1 INCREMENTAL BACKUP UTILITY........................ 1 INTRODUCTION..................................... 1 OVERVIEW....................................... 1 CAPABILITIES................................... 2 BENEFITS....................................... 4 HARDWARE REQUIREMENTS.......................... 4 SOFTWARE REQUIREMENTS.......................... 4 HOW TO USE THE PROGRAM........................... 5 INVOCATION..................................... 5 DISPLAYING THE FUNCTION KEY DEFINITIONS........ 8 FUNCTION KEY DEFINITIONS....................... 8 OTHER KEYS..................................... 11 COLOR/CRAPHICS ADAPTER CONTROL................. 13 APPENDIX A FILENAME DISPLAY SCREEN LAYOUT......... 15 APPENDIX B RESTART DISPLAY SCREEN................. 20 APPENDIX C MESSAGES............................... 22 APPENDIX D FUNCTION KEY REFERENCE................. 27 APPENDIX E USER SUPPORTED SOFTWARE CONCEPT........ 28 AVAILABILITY................................... 28 COPYING........................................ 28 DISCLAIMER..................................... 28 PERMISSION TO COPY............................. 28 THE USER-SUPPORTED CONCEPT..................... 28 . 28 THE USER-SUPPORTED CONCEPT..................... 28